NOTICE: The software in this package is intended only for education and experiment. It is not intended to be shipped as a product; it is therefore not licensable. This software is provided only to illustrate certain aspects of SCSI driver development.
This is a sample disk driver that supports the asynchronous SCSI Manager (SCSI Manager 4.3). It is written in MPW C with a small amount of assembler interface "glue." It was compiled under MPW 3.3.1 (ETO 13).
It correctly demonstrates asyncronous I/O, simple completion routine state machines, the transition from one SCSI Manager to another, using the new driver rules and so on. On the other hand it doesn't do much error handling and doesn't work on the Mac Plus. No provision is made to support vendor- or version-specific disk hardware or firmware. In particular, note that this sample does not use the automatic Request Sense capability of the asynchronous SCSI Manager.
Since this is just an example you don't want to just copy it into your product but, rather, use it as an example so you understand how to integrate the capabilities of the asynchronous SCSI Manager into your device drivers.. You will have to add error handling and specific device support into the driver. As you look through the code keep in mind that it was hacked out of generations old hard disk drivers. Every attempt has been made to make the code work properly but you never know, something might have slipped by the censors - er I mean editors.
The makefile will build a resource file which contains a resource of type 'scsi'. You can paste this resource into HD SC Setup if you wish to test it. (Note that you must not distribute a modified copy of HD SC Setup.) The cksum tool is an MPW tool which generates the driver checksum and places it into the driver.
Hopefully this code will be an aid to you in getting your own driver up and running. Enjoy (or at least as much as is possible with SCSI).
